<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
	"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-type" content="text/html; charset=utf-8" />
<title>data(name)</title>
<meta name="keywords" content="jQuery 1.2 API Reference,Visual jQuery 1.2,jQuery doc,jQuery API,jQuery,jQuery 1.2 API 参考文档中文版,中文版" />
<meta name="description" content="jQuery 1.2 API 文档中文版，提供最新版 jQuery 开发帮助。" />
<link rel="stylesheet" type="text/css" href="../../style/jqueryapi.css" />
<script type="text/javascript" src="../../style/lib/jquery126.js"></script>
 </script>
<script type="text/javascript" src="../../style/jqueryapi.js"></script>
<link rel="shortcut icon" href="../../style/img/favicon.ico" />
</head>
<body>
<div id="topnav">
		<a href="http://www.jQuery.com/" title="jQuery官网" target="_blank" class="topnav">jQuery官网</a>
	<span class="topnav">|</span>
	<a href="http://jquery.org.cn/" title="jQuery中文网站" target="_blank" class="topnav">jQuery中文网站</a>
	<span class="topnav">|</span>
	<a href="http://www.cn-cuckoo.com/" title="1.1版译者" target="_blank" class="topnav">为之漫笔</a>
	<span class="topnav">|</span>
	<a href="http://shawphy.com/" title="1.2版翻译整理者" target="_blank" class="topnav">Shawphy</a>
    <span class="topnav">|</span>
	<a href="http://www.51toria.cn" title="CHM文档制作者:一揪" target="_blank" class="topnav">CHM文档制作者</a> 
	<span class="topnav">|</span>
	<a href="http://dl.getdropbox.com/u/81097/jQueryAPI_CHM.CHM" title="" target="_blank" class="topnav">CHM最新版本下载</a> 
</div>
<hr style="color:#595959;" />

<div class="content">
				<h1>data(name)</h1>
				<div class="desc"><div>返回元素上储存的相应名字的数据，可以用data(name, value)来设定。</div><div class="longdesc"><p>如果jQuery集合指向多个元素，那将只返回第一个元素的对应数据。</p><p>这个函数可以用于在一个元素上存取数据而避免了循环引用的风险。jQuery.data是1.2.3版的新功能。你可以在很多地方使用这个函数，另外jQuery UI里经常使用这个函数。</p></div>
				<hr /><div>Returns value at named data store for the element, as set by data(name, value).</div> <div class="longdesc"><p>If the JQuery collection references multiple elements, the value returned refers to the first element.</p><p>This function is used to get stored data on an element without the risk of a circular reference. It uses jQuery.data and is new to version 1.2.3. It can be used for many reasons and jQuery UI uses it heavily. </p></div></div>
				<h2>返回值</h2>
				<p class="indent">Any</p>
				<h2>参数</h2>
				<p class="indent"><strong>name </strong>(String) :存储的数据名 </p>
				<h2>示例</h2>
				<p class="indent">
					在一个div上存取数据
				</p>
				<p class="indent"><strong>HTML 代码:</strong></p>
				<div class="code">
					&lt;div&gt;&lt;/div&gt;
				</div>
				<p class="indent"><strong>jQuery 代码:</strong></p>
				<div class="code">
					$("div").data("blah");  // undefined<br/>
					$("div").data("blah", "hello");  // blah设置为hello<br/>
					$("div").data("blah");  // hello<br/>
					$("div").data("blah", 86);  // 设置为86<br/>
					$("div").data("blah");  //  86<br/>
					$("div").removeData("blah");  //移除blah<br />
					$("div").data("blah");  // undefined
				</div>
				<hr />
				<p class="indent">
					在一个div上存取名/值对数据
				</p>
				<p class="indent"><strong>HTML 代码:</strong></p>
				<div class="code">
					&lt;div&gt;&lt;/div&gt;
				</div>
				<p class="indent"><strong>jQuery 代码:</strong></p>
				<div class="code">
					$("div").data("test", { first: 16, last: "pizza!" });<br />
					$("div").data("test").first  //16;<br />
					$("div").data("test").last  //pizza!;
				</div>
			</div>

</body>
</html>
